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3.1 Building on the Experience of 
Others 


Software engineers should avoid re- 
developing software already developed 


Types of reuse: 
* Reuse of expertise 
* Reuse of standard designs and algorithms 
* Reuse of libraries of classes or procedures 


* Reuse of powerful commands built into 
languages and operating systems 


e Reuse of frameworks 


| * Reuse of complete applications 
www.lloseng.com 
© Lethbridge/Laganière Chap. 3: Basing Development on Reusable 2 
2005 


Technology 


3.2 Reusability and Reuse in SE 


Reuse and design for reusability should be part 
of the culture of software development 
organizations 


But there are problems to overcome: 


* Why take the extra time needed to develop 
something that will benefit other 
projects/customers? 


* Management may only reward the efforts of 
people who create the visible ‘final products’. 


* Reusable software is often created in a hurry 
i and without enough attention to quality. 
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A vicious cycle 


Developers tend not develop high quality reusable 
components, so there is often little to reuse 


To solve the problem, recognize that: 
* This vicious cycle costs money 
* Investment in reusable code is important 


* Attention to quality of reusable components is 
essential 


—So that potential reusers have confidence in them 
—The quality of a software product is only as good 
as its lowest-quality reusable component 
* Developing reusable components can often simplify 
design 
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3.3 Frameworks: Reusable Subsystems 


A framework is reusable software that 
implements a generic solution to a 
generalized problem. 


*[t provides common facilities applicable to 
different application programs. 


Principle: Applications that do different, 
but related, things tend to have quite 
similar designs 
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Frameworks to promote reuse 


A framework is intrinsically incomplete 


* Certain classes or methods are used by the 
framework, but are missing (slots) 


«Some functionality is optional 


— Allowance is made for developer to 
provide it (hooks or extension points) 


* Developers use the services that the 
framework provides 


—Taken together the services are called 


| | | the Application Program Interface (APD 
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Object-oriented frameworks 


In the object oriented paradigm, a 
framework is composed of a library of 
classes. 


°The API is defined by the set of all public 
methods of these classes. 


e Some of the classes will normally be abstract 
and there are often many Interfaces 


Example: 
*A framework for payroll management 
e A framework for frequent buyer clubs 
e A framework for university registration 


| e À framework for e-commerce web sites 
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Frameworks and product lines 


e A product line (or product family) is a set of 
products built on a common base of 
technology. 

—The various products in the product line 
have different features to satisfy different 
markets 

—The software technology common to all 
products in included in a framework 

—Each product is produced by filling the 
available hooks and slots 


—E.g. software products offering 'demo', 


| ‘lite’ or ‘pro’ versions 
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Types of frameworks 


eA horizontal framework provides general application 
facilities that a large number of applications can use 


°A vertical framework (application framework) is more 
‘complete’ but still needs some slots to be filled to adapt 


it to Specific annlinntinn nando 
m Services offered um 
Application by the framework Application 


Horizontal framework 


Slot Hook 


Hook 


Slot 


Vertical 


framework 


Np 5 


Code to be provided to adapt the framework 
to the needs of rhe application 
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3.4 The Client-Server Architecture 


A distributed system is a system in which: 
*computations are performed by separate programs 
*... normally running on separate pieces of hardware 
*... that co-operate to perform the task of the system. 

Server: 


* A program that provides a service for other 
programs that connect to it using a communication 
channel 

Client 


* A program that accesses a server (or several 
servers) to obtain services 

*A server may be accessed by many clients 
simultaneously 
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Sequence of activities in a client- 
server system 


1. The server starts running 


2. The server waits for clients to connect. 
(listening) 


3. Clients start running and perform operations 
— Some operations involve requests to the server 


4. When a client attempts to connect, the server 
accepts the connection (if it is willing) 

5. The server waits for messages to arrive from 
connected clients 

6. When a message from a client arrives, the server 
takes some action in response, then resumes 
waiting 

7. Clients and servers continue functioning in this 
manner until they decide to shut down or 


| disconnect 
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A server program communicating with 
two client programs 


| 
| 
listen for connections i 
l 
l 


connect 


| 
| 
| 
| 
| 
| 
| 
send message 
| 


connect 


disconnect 


send message 


disconnect 


stop listening 
| 
| 
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Alternatives to the client server 
architecture 


e Have a single program on one computer that 
does everything 


e Have no communication 


— Each computer performs the work 
separately 


* Have some mechanism other than client- 
server communication for exchanging 
information 


—E.g. one program writes to a database; the 


| other reads from the database 
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Advantages of client-server systems 


*The work can be distributed among different 
machines 


* The clients can access the server's functionality 
from a distance 


* The client and server can be designed separately 
* They can both be simpler 
* All the data can be kept centrally at the server 


* Conversely, data can be distributed among many 
different geographically-distributed clients or 
Servers 


* The server can be accessed simultaneously by 
many clients 


* Competing clients can be written to communicate 


| with the same server, and vice-versa 
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Example of client-server systems 


*The World Wide Web 

* Email 

* Network File System 
*'[ransaction Processing System 
* Remote Display System 

* Communication System 

* Database System 
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Activities of a server 


1. Initializes itself 
2. Starts listening for clients 
3. Handles the following types of events originating from 


clients 
For the server as a whole: 
1.accepts connections 3 
2.responds to messages start listening] — | stop listening cae 
z á terming 
3.handles client dBconniéuti ; 
4. May stop 
listening 


1. Must cleanly terminate 


handle 


disconnection 


For each connection: 


Handling a Connection 
do: react to messages 
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Activities of a client 


Initializes itself 
Initiates a connection 
Sends messages 
Handles the following 
types of events 
originating from the 
server 

1. responds to messages 


handles server 
disconnection 


5. Must cleanly terminate 


initialize 


initiate a connnectian 
lo a server 


m W N e 


respond to events 


interact with the user, i 
triggered by the server 


sending messages to the 
server ds necessary do/ respond to messages 
do/ handle server disconnection 


terminate 
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Threads in a client-server system 


Client Side (Client A) Server Sida 


wait For 
server events 


wait for 


messages: 
cliant B 


interact 
with user 


interact with 
server usar 


wait for 
messages: 
client A 


reply to message 


reply to message 


disconnact 


wait for 
connections 
connect 


send message] | | 


send message 


display reply | 


kill client 


display 
disconnect 


Xx — 0 eG | 
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Thin- versus fat-client systems 


Thin-client system (a) 
* Client is made as small as possible 
* Most of the work is done in the server. 
* Client easy to download over the network 
Fat-client system (b) 
* As much work as possible is delegated to the clients. 
e Server can handle more clients 


Light computation 


simple 
commands 


Heavy computation 
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Communications protocols 


* The messages the client sends to the server 
form a language. 

— The server has to be programmed to 
understand that language. 

* The messages the server sends to the client 
also form a language. 

— The client has to be programmed to 
understand that language. 

* When a client and server are communicating, 
they are in effect having a conversation using 
these two languages 

* The two languages and the rules of the 
conversation, taken together, are called the 


| protocol 
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Tasks to perform to develop 
client-server applications 


1. Design the primary work to be performed by 
both client and server 


2. Design how the work will be distributed 


3. Design the details of the set of messages 
that will be sent 


4. Design the mechanism for 
1. Initializing 
2. Handling connections 
3. Sending and receiving messages 
4. Terminating 
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3.5 Technology Needed to Build Client- 
Server Systems 


Internet Protocol (IP) 

* Route messages from one computer to another 

* Long messages are normally split up into small pieces 
Transmission Control Protocol (TCP) 

* Handles connections between two computers 


* Computers can then exchange many IP messages over a 
connection 


* Assures that the messages have been satisfactorily 
received 


A host has an IDP address and a host name 
* Several servers can run on the same host. 
* Each server is identified by a port number (0 to 65535). 


* To initiate communication with a server, a client must 
know both the host name and the port number 
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Establishing a connection in Java 


The java.net package 


* Permits the creation of a TCP/IP connection 
between two applications 


Before a connection can be established, the 
server must start listening to one of the ports: 
ServerSocket serverSocket = new 
ServerSocket(port); 
Socket clientSocket = serverSocket.accept(); 


For a client to connect to a server: 
Socket clientSocket= new Socket(host, port); 
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Exchanging information in Java 


* Each program uses an instance of 


— InputStream to receive messages from 
the other program 


— OutputStream to send messages to the 
other program 


—These are found in package java.io 


output = clientSocket.getOutputStream(); 


input = clientSocket.getinputStream(); 
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Sending and receiving messages 


s without any filters (raw bytes) 
output.write(msg); 
msg - input.read(); 


e or using DatalnputStream / DataOutputStream 
filters 


output.writeDouble(msg); 
msg = input.readDouble(); 


e or using ObjectinputStream / ObjectOutputStream 
filters 


output.writeObject(msg); 


| msg - input.readObject(); 
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(OCSF) 


AbstractClient 


«control» 
epenConnection| | 
sendToServer() 
closeConnection(| 

shooks 
connectionEstablishad() 
connectionClosad() 
connectionException(] 

«slots 
handlaMassageFromServer[] 

“ACCES Or» 
isConnected() 
geltPort(] 
setPort | 
getHost() 
setHost() 
gelnetAddress() 


3.6 The Object Client-Server 
Framework 


AbstractServer 


«control» 
listen() 
stoplistening{| 
doseli 
send ToAllCliants| | 
«hooks 
server Started| | 
cientConnected|(] 
clientDisconnected|| 
dientExceptioni) 
server Stopped|| 
listaningException() 
serverClosed{| 
«slots 
handle MessageFromClient() 
successor» 
isListening) 
getNumberOfCliants(] 
getCliantConnections(| 
getPort|] 
satPort(| 
satBacklog(] 


ConnectionToCliant 


sendTocClient(] 
dose() 
getlnetAddrass() 
setinfo(] 
getinfo(] 
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Using OCSF 


Software engineers using OCSF never modify 
its three classes 


They: 
* Create subclasses of the abstract classes in the 
framework 


* Call public methods that are provided by the 
framework 


* Override certain slot and hook methods 


| (explicitly designed to be overridden) 
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3.7 The Client Side 


Consists of a single class: AbstractClient 
* Must be subclassed 


—Any subclass must provide an 
implementation for 
handleMessageFromServer 


- Takes appropriate action when a message is 
received from a server 


e Implements the Runnable interface 


—Has a run method which 
- Contains a loop that executes for the lifetime 


: of the thread 
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The public interface of AbstractClient 


Controlling methods: 
* openConnection 
* closeConnection 
* sendToServer 


Accessing methods: 
* isConnected 
* getHost 
* setHost 
* getPort 
* setPort 
e getinetAddress 
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The callback methods of 
AbstractClient 
Methods that may be overridden: 


e connectionEstablished 
*connectionClosed 


Method that must be implemented: 
e handleMessageFromServer 
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Using AbstractClient 


e Create a subclass of AbstractClient 


* Implement handleMessageFromServer 
slot method 


* Write code that: 
—Creates an instance of the new subclass 
—Calls openConnection 


—Sends messages to the server using the 
sendToServer service method 


* Implement the connectionClosed callback 
* Implement the connectionException 


| callback 
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Internals of AbstractClient 


Instance variables: 

* A Socket which keeps all the information 
about the connection to the server 

*Two streams, an ObjectOutputStream and 
an ObjectInputStream 

* A Thread that runs using AbstractClient's 
run method 

*Two variables storing the host and port of 
the server 
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3.8 The Server Side 


Two classes: 


* One for the thread which listens for new 
connections (AbstractServer) 


s One for the threads that handle the 
connections to clients 
(ConnectionToClient) 
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The public interface of AbstractServer 


Controlling methods: 
e listen 
* stopListening 
* close 
e sendToAllClients 


Accessing methods: 
* isListening 
* getClientConnections 
* getPort 
* setPort 
* setBacklog 
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The callback methods of 
AbstractServer 


Methods that may be overridden: 
*serverStarted 
* clientConnected 
* clientDisconnected 
* clientException 
*serverStopped 
e listeningException 
*serverClosed 
Method that must be implemented: 
* handleMessageFromClient 
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The public interface of 
ConnectionToClient 


Controlling methods: 
esendToClient 
e close 


Accessing methods: 
e getInetAddress 
e setInfo 
e getInfo 
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Using AbstractServer and 
ConnectionToClient 


* Create a subclass of AbstractServer 
* Implement the slot method 
handleMessageFromClient 
* Write code that: 
— Creates an instance of the subclass of 
AbstractServer 
— Calls the listen method 
— Sends messages to clients, using: 


the getClientConnections and 
sendToClient service methods 


or sendToAllClients 
* Implement one or more of the other 


| callback methods 
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Internals of AbstractServer and 
ConnectionToClient 
* The setInfo and getInfo methods make use of a 
Java class called HashMap 


* Many methods in the server side are synchronized 


e The collection of instances of ConnectionToClient 
is stored using a special class called ThreadGroup 


* The server must pause from listening every 500ms 
to see if the stopListening method has been called 


—if not, then it resumes listening immediately 
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3.9 An Instant Messaging Application: 
SimpleChat 


AbstractClient 


i 


AbstractServer 


PA 


ChatClient EchoServer 


handleMassageFromClient[) 
serverStarted([) 


handle MessageFromServer(| 
diet) handleMessageFremClientUll) 


accept] quitl) 


display) 


serverStopped[) 
maini | 
main 


ClientConsole can eventually be replaced by 
ClientGUI 


www.lloseng.com 
7 © Lethbridge/Laganiére Chap. 3: Basing Development on Reusable 39 
2005 


Technoloav 


The server 


EchoServer is a subclass of AbstractServer 
* The main method creates a new instance and 
starts it 
— It listens for clients and handles 
connections until the server is stopped 
* The three callback methods just print out a 
message to the user 


— handleMessageFromClient, 
serverStarted and serverStopped 


* The s/ot method handleMessageFromClient 
calls sendToAllClients 


| — This echoes any messages 
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Key code in EchoServer 


public void handleMessageFromClient 
(Object msg, ConnectionToClient client) 


System.out.println( 
"Message received: " 
+ msg + " from " + client); 
this.sendToAllClients(msg); 


T 
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The client 


When the client program starts, it creates instances of 
two classes: 


* ChatClient 
—A subclass of AbstractClient 
—Overrides handleMessageFromServer 
- This calls the display method of the user interface 
* ClientConsole 


—User interface class that implements the interface 
ChatIF 


- Hence implements display which outputs to the console 
—Accepts user input by calling accept in its run method 


—Sends all user input to the ChatClient by calling its 
handleMessageFromClientUI 
- This, in turn, calls sendToServer 
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Key code in ChatClient 


public void handleMessageFromcClientUI( 
String message) 


{ 
try 


sendToServer(message); 


} 
catch(IOException e) 
{ 
clientUl.display ( 
"Could not send message. " + 
"Terminating client."); 
quit(); 
} 
} 
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Key code in ChatClient - continued 


public void handleMessageFromServer(Object msg) 


i 
clientUl.display(msg.toString()); 


} 
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3.10 Risks when reusing technology 


* Poor quality reusable components 


— Ensure that the developers of the 
reusable technology: 
- follow good software engineering practices 
- are willing to provide active support 


* Compatibility not maintained 
—Avoid obscure features 


— Only re-use technology that others are 
also re-using 


W www.lloseng.com 
7 © Lethbridge/Laganiére Chap. 3: Basing Development on Reusable 45 
2005 


Technoloav 


Risks when developing reusable 
technology 


* Investment uncertainty 


— Plan the development of the reusable 
technology, just as if it was a product for a 
client 


* The 'not invented here syndrome" 
— Build confidence in the reusable technology 
by: 
- Guaranteeing support 
- Ensuring it is of high quality 


W - Responding to the needs of its users 
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Risk when developing reusable 
technology - continued 


* Competition 
—The reusable technology must be as 
useful and as high quality as possible 


* Divergence (tendency of various groups to 
change technology in different ways) 
— Design it to be general enough, test it 
and review it in advance 
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Risks when adopting a client-server 
approach 


* Security 
— Security is a big problem with no perfect 
solutions: consider the use of encryption, 
firewalls, ... 


* Need for adaptive maintenance 
— Ensure that all software is forward and 
backward compatible with other versions 
of clients and servers 
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